XDS Release 3.0 Addendum 
A 


sus CoCumMent contains a correction to the X Display Starion Release 3.9 
Update Guide. as well as information on Release 2.8 Dug correcuons. and 
Release 3.0 outstanding bugs. 


Remote Configuration Model Types 


On page 18 of the XDS Release 3.0 Update Guide. the second paragraph 
under the heading “Remote Configuration File Specification” contains a 
list of MachineModel types for all XDS models. Please use the following 
MachineModel identifiers (in bold type) instead of those in the guide: 


X14ES X-14/ES 

X15 X-15 

X19 X-19 (1152 x 900 resolution) 
X19ORIG X-19 (1024 x 800 resolution) 
X19TURBO X-19 Turbo 

XTC2 Color Xbase/10 

XTC3 Color Xbase/11 & Xbase/12 


Bugs Fixed for Release 3.0 
Cennnnnerrer rere reece eee 
The following Release 2.8 software bugs have been fixed for Release 3.0: 


° Wildcard characters (*) in remote configuration files were not 
handled correctly. resulting in bogus error messages. Field separa- 
tors (.) were required. as in these examples: 


Visual.*.Reysliek 
©.° geyelie® 


For 3.0, the field separators are not required. as shown here: 


Visual *Reyelick 
*Reyelick 


° X clients can no longer ring the bell when Audible Bell in the 
Configure Keyboard/Mouse menu is set to Off. 


° TFTP errors during the boot process were not flushed. Conse- 
quently, the boot command seemed to fail silently. and an error 
message was displayed after the next successful command. This 
has been corrected. 
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Disclaimer: 


The information contained in this manual is believed to be accurate and reliable. 
However, Visual Technology Incorporated assumes no responsibility whatsoever 
for any errors, omissions, or inaccuracies. Visual Technology Incorporated dis- 
claims any and all warranties, express or implied, including the warranty of 
merchantability and fitness for a particular purpose, with respect to the informa- 
tion contained in this manual and the hardware and software described herein. 
The entire risk as to the quality and performance of such information and equip- 
ment is upon the buyer or user. 


Visual Technology Incorporated shall not be liable for any damages, including 
special or consequential damages, arising out of the use of such information or 
equipment, even if Visual Technology Incorporated has been advised in advance 
of such damages. The use of the information contained in this manual and the 
equipment described herein is subject to Visual Technology Incorporated's stan- 
dard license agreement, which must be executed by the buyer or user before the 
use of such information or software. 


This warranty gives you specific legal rights. You may also have other rights, 
which vary from state to state. Some states do not allow the exclusion or limita- 
tion of incidental or consequential damages or limitations on how long an implied 
warranty lasts, so the above limitations or exclusion may not apply to you. 


Visual Technology Incorporated, 120 Flanders Road, Westboroough, MA 0158] 
1-800-537-6004 (outside MA) 1-800-345-8998 (inside MA) 


DECwindows is a trademark of the Digital Equipment Corporation. 

NFS is a trademark of Sun Microsystems Incorporated. 

XDS & X Display Station are trademarks of Visual Technology Incorporated. 
X & the X Logo are trademarks of the Massachusetts Institute of Technology. 


Copyright 1990, Visual Technology Incorporated 
X Display Station Release 3.0 Update Guide, Part Number 90-0000-006 
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Introduction 


-_—_---——————————— 


This supplement to Visual’s X Display Station User’s Guide describes XDS 
software Release 3.0, which is fully compliant with the MIT X.V11R4 
server specification. XDS Release 3.0 includes support for: 


° The X Display Manager Control Protocol (XDMCP), which controls 
the user’s X terminal login session from Startup to shutdown. 


° The SHAPE extension, which permits windows to be of any shape. 
(A clock or a control button, for example, might be round rather 
than rectangular.) 


° The MIT-MAGIC-COOKIE- 1 security extension, which, when used 
in conjunction with XDMCP, permits only users with the MIT- 
MAGIC-COOKIE-1 authorization code to establish any new XDS 


connections. 

° Optimized wide lines and arcs, which includes enhanced user 
specification for line widths and endcaps. ) 

° Optimized software cursors. 

° Optimized server region code. 

° Real window save-unders. 

° Input extension support, so alternate input devices can generate 


standardized events. 


In addition, a default ISO standard 8859.1 international font, stored in 
ROM, can be used in the XDS setup windows, XDS connection window, 
and X windows. This is also one of the standard fonts selectable in XDS 
setup mode through the Configure Font Management Menu and the 
Configure Connection Menu. 


You should already be familiar with the XDS installation and configuration 
procedures described in the X Display Station User’s Guide. Only new XDS 
Release 3.0 features are covered in this document. 


Network Special Keywords 


Unless you have supplied a specific Internet Protocol (IP) address, the XDS 
knows only its hardware address, not its IP address, when it starts up. 


The XDS works only if it knows its IP address. If you don’t specify an IP 
address, or if you use 0, the XDS sends out Reverse Address Resolution 
Protocol (RARP) and Bootstrap (BOOTP) requests on the network to learn 
its IP address from a network host. This host matches the XDS hardware 
address with the corresponding XDS IP address. 
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For the XDS hardware address to correspond to an IP address, the XDS 
hardware address must be entered in the RARP or BOOT? data bases on 
the servers. The network administrator who maintains these data bases 
should be notified of the XDS hardware address. 


Two network special keywords can be used in place of any network host 
name in the XDS setup and connection windows: 


° BROADCAST - The XDS replaces this keyword with the IP broad- 
cast address. You can set this address using the Configure 
Ethernet Menu, or the XDS can set it automatically. 


° BOOTPHOST - The XDS replaces this keyword, wherever in the 
XDS setup menus it is used, with the IP address of the host that 
responds successfully to the XDS BOOTP request. 


NOTICE: The XDS issues a BOOTP request only if you have not set the IP address 
of the XDS using the Boot ROM or Configure Ethernet Menu. If you manu- 
ally set this IP address, references to BOOTPHOST in the setup menus 
cannot be resolved. 


The Configure Network Services Menu 


Three new items have been added to the Network Services Menu, and 
NFS Authentication Mode has been moved here from the Font Manage- 
ment Menu: 


CONFIGURE NETWORK SERVICES 


To change an item, highlight it and press the left mouse button or RETURN. 
Press the right mouse button or ESC to return to the Setup Window. 
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Edit Local IP Namelist 

Edit |EN116/U0P Nameserver List 

Edit Domain Nameserver List 
Nameserver Request Timeout (seconds) 


Domain Name 
Default Router (none if proxy ARP) 


TCP Maximum Packet Size 
TCP Maximum Window Size 


4.2 Compatibility Mode 
UDP Checksummin 
ARP Dally (seconds 


NFS Authentication Mode AUTH_UNIX namexLOCALNAME 


HELP 
Return to Setup Window 


NOTICE: 
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XDS Local Name 


This allows you to assign an alphabetic name which maps to the unique 
IP address of the XDS. The XDS then uses this Local Name in the NFS 
Authentication Mode item, described below. The default name is 
“unknown”, 


TCP Maximum Packet Size 


This is the maximum size, in bytes, of the TCP packet the XDS generates. 
This is useful if your network routers or bridges do not send TCP com- 
mands to tell XDS terminals to use smaller packet sizes. 


The default is 1460 bytes. 


TCP Maximum Window Size 


This is the maximum size, in bytes, of the XDS buffer for unacknowledged 
packets. This item is for use with hosts that have problems with large 
window sizes. 


The default is 3072 bytes. 


If the XDS determines that the host it is talking to needs a lower packet 
size or window size, then that lower value will be used. This is decided on 


a host-by-host basis. 
an 


NFS Authentication Mode 


This item is has been moved here from the Font Management Menu. The 
options are: 


AUTH_NONE - Select this option to have the XDS provide no authentica- 
tion information in its requests over NFS. 


AUTH_UNIX name = LOCALNAME - Select this option to have the XDS 
provide unique information about its identity in requests over NFS, 
using the name you set in the XDS Local Name item above. 


AUTH_UNIX name = xds - Select this option to have the XDS provide 
information about its general identity in requests over NFS. The 
NFS server looks up “xds” to verify that it matches the XDS IP 
addresses. 
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The Font Management Menu 


EE 
The NFS Authentication Mode item (which now controls all NFS access 
to the host) has been been moved from the Font Management Menu to 
the Network Services Menu. Two other items have been revised: 


Edit Font Host List 


The default setting is now the “BOOTPHOST” keyword (see the “Network 
Special Keywords” section above.) 


Edit Font Path List 
The font path list now defaults to: 


/usr/1lib/X11/Visual/fonts/misc 
/usr/lib/X11/Visual/fonts/100dpi 
/usr/1ib/X11/Visual/fonts/75dpi 


The Configure Auto-Connection Menu : 

LE 
Visual has made several enhancements to the Auto-Connection Menu to 
support the X Display Manager Control Protocol (KDMCP) specified in 
X.V11R4. 


CONFIGURE AUTO CONNECTION 


To change an item, highlight it and press the left mouse button or RETURN. 
Press the right mouse button or ESC to retum to the Setup Window. 


Auto connection Mode XI) MCH 
dit Connection Host List 


XOMCP Callout Mode Direct 
XDOMCP Host Selection Mode First Willing 
XOMCP Retry after Connect Failure Yes 
XDMCP Connect Timeout (seconds) 4 

XOMCP Check for Dead Session Yes 
XOMCP Session Check Interval (min) 3 

XDMCP UDP Port 


XDSXDM Request Timeout (seconds) 
XOSXOM Daemon UDP Port 


HELP 
Retum to Setup Window 


FYgure 2 The Configure Auto-Connection Menu 
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Auto-Connection Mode 
EL RS AA re 


XDMCP - This is the X Display Manager Control Protocol supported by 
X.V11R4. Whereas XDSXDM makes the host connection exclusively 
on a first-come-first-served basis, XDMCP provides a greater variety 
of query requests and X display manager connection schemes. 
These are fully described under “XDMCP Callout Mode” below. 


XDSXDM - This is an early X Display Manager (XDM) protocol Visual 
added to X.V11R3. When XDSXDM is selected, the XDS attempts 
to connect to a daemon version of the XDM which runs on a host. 
The XDS issues an “X Login Request” to each host in the Connec- 
tion Host List and establishes a connection with the first host that 
responds. This selection is not compatible with the X.V11R4 
XDMCP protocol. 


Only the above XDMCP and XDSXDM selections bring you directly 
to an X Display Manager login window whenever you log out of a 
current X windows session, reboot, or power-up the terminal. 


Telnet on Reboot - With this item selected, the XDS automatically brings 
up the Connection Window whenever you power-up or reboot the 
terminal using the Reset Terminal (reboot) item on the System 
Window. If there is a host in the Connection Host List, the com- 
mand line will contain the string “telnet hostname”. To actually 
initiate the telnet session, just press the ENTER key. If you’d rather 
connect to a different host than the default, simply backspace over 
the host name and type in another. 


Telnet on Logout - With this item selected, the XDS brings up the Con- 
nection Window not only on power-up and reboot, but also when- 
ever you log out of your last X client connection, or when you select 
the Close All Connections (logout) item in the System Window. 


Disabled - When selected, the XDS makes no attempt to connect to any- 
thing at reboot, power-up, or server reset (logout). 


Auto-Connection Mode is a toggle item. The default is XDMCP. 


Edit Connection Host List 


The default setting is now the “BOOTPHOST” keyword (see the “Network 
Special Keywords” section above.) 


XDMCP Callout Mode 


This item indicates the type of XDMCP connection request made by the 
XDS. In each case, the XDS sends a query to determine if a host is willing 
to provide the terminal with X display management services. 
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Direct - This is a request sent to a specific host (or hosts) on the Con- 
nection Host List. Each host in the list is queried in order, and 
responds with Willing if it is ready to service the terminal, or Unwill- 
ing if it is not. 

Broadcast - This request is broadcast to all hosts on the network (or sub- 


network). An unwilling host ignores the broadcast request, and 
does not respond. 


Indirect - This request is sent to a host on the Connection Host List, 
which then forwards the request to a number of secondary hosts. 
Typically, the known host is a gateway to another network. Unwill- 
ing hosts ignore the request, and do not respond. 


XDMCP Callout Mode is a toggle item. The default is Broadcast. 


XDMCP Host Selection Mode 


This is the method the XDS uses to select a host from among those willing 
to establish a connection. XDMCP Host Selection Mode has 3 options: 


First Willing - The XDS accepts the first Willing host response and estab- 
lishes a connection to that host. 


List Order Priority - The XDS queries all hosts on the Connection Host 
List, and connects immediately if the first host responds Willing. 
Otherwise, after the XDMCP Connect Timeout period, it connects 
with the topmost willing host. 


If no host on the Connection Host List was willing, no connection 
is made, unless XDMCP Callout Mode is Broadcast. In this case, 
the XDS connects with the first willing host not on the list. 


User Selectable - (Local client option only) The XDS does not automati- 
cally connect to any willing host, but instead displays a list of all 
willing hosts, from which you make a selection. 


When you logout, or close all connections from the System Window, 
the server resets, and the Host Query Manager (a local client), 
displays a window with a list of all willing hosts. You then use the 
mouse to choose a host, and select the Connect button. If the 
preferred host is not on the Willing list, you can select Retry 
HostQuery. 


Since this is a local client and not a setup menu, you can go into 
setup mode, change the XDMCP selection mode to First Willing or 
List Order Priority, exit setup, and select Quit in the Host Query 
Manager window. This resets the server and automatically connects 
you to a willing host. 


XDMCP Host Selection Mode is a toggle item. The default is First Willing. 
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XDMCP Retry. after Connect Failure 


This Yes/No item indicates whether or not the XDS should keep trying to 
connect with a host that does not respond to a connection request. If Yes, 
the XDS retries after the XOMCP Connect Timeout interval. Eventually, 
the XDS ceases sending requests if there is no willing response. 


XDMCP Retry after Connect Failure is a toggle item. The default is Yes. 


XDMCP Connect Timeout 
ee 


This is the initial timeout interval, in seconds, between attempts to re- 
establish a connection with a host. If no host responds, this interval be- 
comes longer up to a predefined limit (in case network response is unusu- 
ally slow). 


The default is 4 seconds. 


XDMCP Check for Dead Session 


This Yes/No item indicates whether or not the XDS should send periodic 
messages to find out if the connection host is still running. An active host 
returns an Alive message to the terminal. If the XDS determines the host 
is no longer active, it kills all client application windows, and the server 
resets. 


XDMCP Check for Dead Session is a toggle item. The default is Yes. 


XDMCP Session Check Interval 
This is the interval, in minutes, between session check messages to the 
host. This is meaningful only if XDMCP Check for Dead Session is Yes. 


The default is 3 minutes. 


XDMCP UDP Port 
eee 
This is the UDP port the XDS uses to communicate with XDMCP daemons 


on the remote host. 
The default is 177. 
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The Configure Keyboard/Mouse Menu 

SS Sess sssnsstsusssesssusnssssessenses 
XDS Release 3.0 enables you to select from a set of standard international 
keyboards, and to configure the numeric keypad to suit different platforms 
and applications. 


CONFIGURE KEYBOARD MOUSE 


To change an item, highlight it and press the left mouse button or RETURN. 
Press the right mouse button or ESC to retum to the Setup Window. 


uto-repeat 


Mouse Acceleration Threshold (pixels) 3 
Mouse Acceleration 4 


Audible Bell 


Modifier to Access XDS Special Keys None 
Swap Ctri and Caps Lock Keys No 
Special Key Mapping None 


Keyboard Language Mapping US 
Keypad Mode Local NumLock 
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HELP 
Return to Setup Window 
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Modifier to Access XDS Special Keys 


IF your XDS has a VT220 keyboard, you can define a modifier key that 
activates one of the XDS special keys (MESSAGES, RESET, SETUP, CON- 
NECT, and BREAK). With a modifier pressed, the XDS interprets the above 
keys as XDS special keys, and without the modifier, as F1 through F5. 


None - When None is selected, F1-F5 are always assumed to be XDS 
special keys and do not work as function keys. 


Shift - When Shift is selected, the XDS assumes an XDS special key only 
when you press SHIFT and an XDS special key at the same time. 
When you do not press SHIFT, the XDS assumes a function key 
(F1-F5). 


Ctrl - When Ctrl is selected, the XDS assumes an XDS special key only 
when you press CTRL and an XDS special key at the same time. 
When you do not press CTRL, the XDS assumes a function key 
(F1-F5). 


Modifier to Access XDS Special Keys is a toggle item. The default is None. 


NOTICE: 
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Special Key Mapping 


This item changes the mapping of some function keys to be compatible 
with VAX or VMS hosts. 


None - This setting does not change any function keys. 
F11=ESC - This changes the mapping of the F11 key to ESCAPE. 


F11=ESC/F12=BS/F13=LF - This changes the mapping of the F1]1 key to 
“Escape”, F12 to “BackSpace”, F13 to “LineFeed’. 


Special Key Mapping is a toggle item. The default is None. 


Keyboard Language Mapping 


This toggle item offers a choice of five keyboard maps: US English, 
German, French, UK English, and Swedish/Finnish. Changes immedi- 
ately take effect upon leaving setup, and X clients receive the appropriate 
mapping notify event. The default is US English. 


Each option has a default keyboard map in ROM, which, when selected, is 
copied as the current X server keyboard map. You can further modify this 
keyboard map copy by downloading a keymap file from a host on your 
network. (See the Remote Configuration Menu and “Keyboard Map File 
Specification” for more information.) 


The XDS Setup Menus and Connection Window use the same keyboard 
map as the X server. Therefore, any non-standard keymaps affect setup 
and terminal emulation as well as X applications. 


a 
When the VT220 keyboard is installed, you can only select US English. 
The XDS disables selection of any other keyboard map. You can, however, 
still download modifications in a keymap file. 


Keypad Mode 

ce ee 
This item, which allows you to assign different keymaps for the numeric 
keypad, has the following options: 


Numeric Unshifted - In lower case mode, keys “0” through “9” are nu- 
meric. In upper case mode (SHIFT key pressed), keys “O” through 
"9", except “5”, are used to position the character cursor (or XDS 
Setup cursor). This mapping avoids problems with xterm and DEC 
applications. 


Numeric Shifted - In lower case mode, keys “0” through “9”, except “5”, 
are used to position the character cursor (or XDS Setup cursor). In 
upper case mode (SHIFT key pressed), keys “O” through “9” are 
numeric. | 
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Numeric Only -— This setting uses both upper case and lower case for 
numeric key values. This is primarily for DEC applications. 


Local NumLock - The X terminal emulation program (xterm) does not 
recognize the NUMLOCK key when it is pressed. If you are using an 
application, like xterm, that does not recognize the NUMLOCK key, 
then Local NumLock causes the XDS to remap the numeric keypad 
to numeric unshifted when you press NUMLOCK. When NUMLOCK 
is off, it remaps the numeric keypad to numeric shifted. 


If Local NumLock is set and NUMLOCK is turned on, the LED on 
the keyboard lights up, and goes out when NUMLOCK is turned off. 


If Local NumLock not set, then all client programs still receive the 
NUMLOCK key code as usual—this does not disable NUMLOCK for 
those programs that normally recognize it. It simply means that for 
programs like xterm NUMLOCK has no effect, and the XDS does not 
remap the numeric keypad if NUMLOCK is pressed. 


Keypad Mode changes are always applied to the current language key- 
board map copied from ROM—for the keypad, this is Numeric Unshifted. 
Likewise, any custom keypad changes you make using a download file 
will, upon power-up or reboot, revert to default before any of the above 
optional settings are applied. You can, however, modify the keypad at any 
time after booting with the Load Keyboard Map Now command in the 
Remote Configuration Menu. 


Keypad Mode is a toggle item. The defaults are Numeric Only for the 
VT220 keyboard, and Local NumLock for the PC/AT keyboard. 


The Configure X Server Features Menu 


The following Release 3.0 enhancements have been made to the X Server 
Features Menu. In addition, the Input Synthesis item has been removed. 


Pre-X11R4 Bug Compatibility 


Several applications have been written to take advantage of certain 
anomalies in the X protocol prior to X.V11R4 (such as setting undefined 
bits in an event mask). Corrections made in X.V11R4 by the X Consortium 
may mean these programs now receive X protocol errors. If you have app- 
lications incompatible with X.V11R4, you may need to set Pre-X11R4 Bug 
Compatibility to Enabled. If you are developing a new client application 
you want to be fully X.V11R4 compliant, set this item to Disabled. 


Pre-X11R4 Bug Compatibility is a toggle item. The default is Enabled. 


ne 
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Old DECwindows Compatibility 


Some versions of DECwindows applications have difficulties with bit- 
ordering of image data files. 


Enabled - This forces the XDS to bit-swap any image data on a connection 
made from a byte-order-switched host. This effectively masks 
a problem with old versions of DECwindows that distorted images 
loaded from a VAX. 


Disabled - This forces the XDS to use image data as-is. 
Old DECwindows Compatibility is a toggle item. The default is Disabled. 


X Protocol Error Reporting 


Enabled - This causes the XDS to print a message in the Messages Win- 
dow whenever an X Protocol error event is sent to an X client. Not 
all errors are fatal, and many are common with standard MIT 
clients.Because of the asynchronous nature of X error reporting, 
this is a valuable debugging feature. 


Disabled - This causes the XDS to silently send client error events. 
X Protocol Error Reporting is a toggle item. The default is Disabled. 


Verbose Messages 


When Enabled, the XDS displays in the Message Window more detailed 
information on its current activities. For example, enable Verbose Mes- 
sages if you are having trouble accessing fonts, or making an auto-connec- 
tion. Enabling this item also gives you error reporting on low memory or 
non-existent fonts. 


Verbose Messages is a toggle item. The default is Disabled. 


The Remote Configuration Menu 


This menu has revised boot host capabilities, and three new items which 
support custom keyboard mapping enhancements. The Remote Configu- 
ration Host item has been changed to Edit Configuration File List. 


Edit Boot Host List 


eee 
XDS Release 3.0 allows you to specify a list of boot hosts. When the XDS 


attempts to TFTP the boot image, it starts at the top of the list, and tries 
to download the boot image from each host until it is either successful or 
reaches the end of the list. 


The default list is the single keyword “BOOTPHOST’”. This means that the 
XDS defaults to booting from the first responding “bootp” host. You can 
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also add the “BROADCAST” keyword at the end of the boot host list, so the 
XDS can download the boot image from the first responding host on the 
network in case “bootp” fails. This combination gives you total control over 
the XDS boot process. 
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To change an item, highlight it and press the left mouse button or RETURN. 
Press the right mouse button or ESC to return to the Setup Window. 


Boot Server Usin 
dit Boot Host List 
Boot Filename /usr/DisvUX19TURBO 


Network File Transfer Protocol TFTP 


Auto-load Configuration On 
Edit Configuration File List 
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Auto-load RGB Database Off 
Edit RGB Database List 
Load RGB Database Now 
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Figure 4 The Remote Configuration Menu 


Auto-Load Keyboard Mapping 


Set this item to On if you want one of the host keyboard map files in the 
Keyboard Map List to be downloaded to the XDS upon power-up or reboot. 


Auto-load Keyboard Map is a toggle item. The default is Off. 


Edit Keyboard Map List 


This is a list of hosts and optional paths for custom keyboard map files. 
You can specify any host and full path name. However, if you specify a 
host name only, the XDS uses the following default path: 


/usr/1ib/X11/Visual/keyboard.map 


The following is an example of a keyboard map list: 


bird 

mchale: /usr/local/lib/keyboard.map 
chief:/tmp/keys.map 

rocket 
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The XDS goes through the list in order, and loads only the first keyboard 
map file it finds. This applies for both Auto-Load Keyboard Mapping and 
Load Keyboard Map Now items. 


The XDS applies only those keymap changes that differ from the currently 
selected keyboard map. Therefore, your custom keyboard map file can be a 
subset of a complete keyboard map. 


The default setting is now the “BOOTPHOST” keyword (see the “Network 
Special Keywords” section above.) 


Load Keyboard Map Now 


Select this command item if you want to immediately download a keyboard 
map file from the host to the XDS. This change takes effect upon leaving 
XDS setup mode. 


Load Keyboard Map Now is a instant-action item. Force the load action to 
occur immediately by highlighting the item and pressing RETURN or the 
left mouse button. 


There is no way to undo this operation. You can, however, clear down- 
loaded keymap changes by doing the following: | 


1. First exit setup mode, then return to setup mode. 


2. Go to the Keyboard/Mouse menu, and cycle through the Keyboard 
Language Mapping options to reset your desired language. 


3. Exit setup mode. The XDS clears any downloaded keymap changes, 
and applies your new keyboard mapping. 
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Remote Configuration File Specification 


The Remote Configuration File is formatted much like an X resource file, 
consisting of one or more lines of the form: 


Manufacturer.MachineModel .Option: Value 


For Visual Technology, the manufacturer is Visual and the 5 possible 
MachineModel types are X15, X19, X15TURBO, X19TURBO, and X14ES. 
The Value depends on the particular option being set. For example: 


Visual.X19.MouseAcceleration: 2 


Some of the settable options allow a list to be entered, in which case the 
list items should be separated by commas. A continuation to the next line 
is indicated by a backslash (\) in the last position on the line, for example: 


Visual.X19.AutoConnectionHostList: nifla,pinta,santamaria 


Visual.X19.FontPathList: /usr/1lib/X11/Visual/fonts/100dpi, \ 
/usr/1lib/X11/Visual/fonts/misce 


Blank lines are ignored. If an exclamation point () appears.anywhere on 
a line, the rest of that line is considered a comment and is ignored. If no 
value appears on a line after the colon, that option is not altered when the 
file is downloaded, and retains its current value. For example: 


Visual.X19.KeyClick: ! Use current setting 


The Manufacturer or the MachineModel and their associated period 
separators may be replaced by an asterisk (*) for universal applicability. 
For example: 


Visual*AudibleBell: On 
would turn on the bell on all Visual products, while: 
*AutoRepeat: Off 


would turn off autorepeat on all manufacturers’ models to which this file 
is downloaded (provided, of course, that they accept this file format). 


Case is not important anywhere except, of course, when it matters to a 
particular option value, such as a UNIX file name. It is important to check 
carefully for syntax errors and mispellings, since many options are not 
checked until actually used by the XDS. 


A sample Remote Configuration File template can be found on the Visual 
Host Utilities Tape, which you can obtain by calling Visual’s Customer 
Support Department. Following is a template showing all current Visual 
setup items: 


I 
| 
! 
1 
! Ethernet Menu 

Ls 
Visual*IpNetworkMask: 


Visual*IpBroadcastAddress: 
Visual*DcpAddr: 


! _—_—— 
: Network Services Menu 

{ 
Visual*XDSLocalName: 
Visual*LocalIpNamelist: 
Visual*Ien1l16UdpNameserverList: 
Visual*DomainNameserverList: 
Visual*DomainName: 
Visual*DefaultRouter: 
Visual*LocalDCPNameList: 


Visual*TCPMaxPacketSize: 
Visual*TCPMaxWindowSize: 
Visual*42Compatibility: 
Visual*UdpChecksumming: 
Visual*ArpDally: 
Visual*NameserverRequestTimeout: 
Visual*NFSAuthentication: 


Yee 
! Serial Line Network Menu 

! eer entrants 
Visual*SerialCommunicationProtocol: 
Visual*SlipIpAddr: 
Visual*SlipNetworkMask: 
Visual*SlipBroadcastAddress: 


reer 
! Serial Port Menu 
Lee 
Visual*SerialPortBaudRate: 


Visual*SerialPortDataBits: 
Visual*SerialPortParity: 
Visual*SerialPortCheckReceiveParity: 
Visual*SerialPortStopBits: 
Visual*SerialPortXonXoffFlowControl: 
Visual*SerialPortRtsCtsFlowControl: 
Visual*SerialPortModemControl: 
Visual*SerialPortRs422Select: 


XDS REMOTE CONFIGURATION FILE TEMPLATE 


—_ — — —_ 


—_ o—_ — — — —_ o—_ — — o—_ — 


— —_ — —_ 


o—_ o_ oan cam ecm ca o— om Cm eam 
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NONE for automatic 
NONE for automatic 
DECnet option ONLY 


<local name> 
<ipaddr name> pairs 
host ID’s 

Host ID’s 


Host ID’s 

<node>.<addr name> 
(DECnet option ONLY) 
number of bytes 

number of bytes 

On, Off 

On, Off 

Number of seconds 
Number of seconds 
AUTH_NONE, AUTH-UNIX=xds, 
AUTH-UNIX=<local name> 


NONE, SLIP 
IP Address 
NONE for automatic 
NONE for automatic 


300, 600, 1200, 2400, 4800, 


7200, 9600, 19200, 38400 
7, 8 


None, Even, Odd, Mark, Space 


Yes, No 

1, 2 

Enabled, Disabled 
Enabled, Disabled 
Enabled, Disabled 
On, Off 
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Pee 
!Font Management Menu - 
Gee 
Visual*DefaultTextFont: 


Visual*FontHostList: 
Visual*FontPathList: 
Visual*NetworkFontAccess: 
Visual*NetworkFontRequestTimeout: 
Visual*FontDaemonUdpPort: 


rrr ee 
! Auto-Connection Menu 
re 
Visual *AutoConnect ionMode: 


Visual*AutoConnectionHostList: 
Visual*XDMCPCalloutMode: 
Visual*XDMCPHostSelectionMode: 


Visual*XDMCPRetryAfterConnectFailure: 


Visual*XDMCPConnectTimeout : 
Visual*XDMCPCheckForDeadSession: 
Visual*XDMCPSessionCheckInterval: 
Visual*XDMCPUdpPort: 

Visual *XDMXDMRequestTimeout: 
Visual*XDSXDMUdpPort: 


Fm 
! Authorization Menu 
Pee 
Visual*HostAuthorization: 
Visual*AuthorizedHostList: 


eee 
! Keyboard/Mouse Menu 

[ —_— 
Visual*KeyClick: 

Visual*AutoRepeat: 

Visual *MouseAccelerationThreshold: 
Visual*MouseAcceleration: 
Visual*AudibleBell: 


Visual *ModifierToAccessXdsSpecialKkeys: 


Visual *SwapCtrlAndCapsLockKeys: 
Visual*SpecialKeyMapping: 
Visual *KeyboardLanguageMapping: 
Visual *SKeypadMede : 


o— Cow — o—_ —_ —_— em 


o—_ —_ om om —_ o—_ — —_ o—_ — — —_ 


o—_ ec coum o—_ —_ o—_ o—_ o— o—_ o—_ o—_ 


6x13, 8x13, 9x15, 10x16, 12x20, 
visual-iso8859-1 
Host ID’s 


Font directory names 

None, FontDaemon, NFS, DAP, TFTP 
Number of seconds 

Font host’s port number 


Disabled, XDMCP, XDSXDM, 

Telnet on Logout, Telnet on Reboot 
Host ID’s 

Broadcast, Direct, Indirect 

First Willing, List Order Priority 
On, Off 

Number of seconds 

Yes, No 

Number of minutes 

XDMCP port number 

Number of seconds 

XDSXDM port number 


Disabled, Active 


Host ID’s 


Inactive, 


On, Off 

Off, Slow, Normal, 
Number of pixels 
Multiplier 

On, Off 

None, Shift, Ctrl 
Yes, No 

None, F1l1l=ESC, F11=ESC/F12=BS/F13=LF 
US, German, 
Local Numlock, Numeric Unshifted, 
Numeric Shifted, Numeric Only 


Fast 


French, UK, Swedish/Finnish 


! 
: A esse dssssseenshesesee> 


! Connection Window Menu 


I 
! SS SS Sees SS 


Visual*ConnectionWindowFont: 
Visual*Connect ionWindowBackground: 
Visual*ConnectionWindowWraparound: 


Visual *Connect ionWindowReverseWraparound: 
Visual*ConnectionWindowAutoNewline: 
Visual*ConnectionWindowCursesEmulation: 
Visual*ConnectionWindowTerminalEmulation: 
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9x15, 12x20, visual-iso8859-1 
White, Black 


On, Off 
On, Off 
On, Off 


! 
! 
| 
! On, Off 
| 
! 
| 


xterm, ANSI, VT102, VT100, VTS2, TTy 


Visual*Connect ionWindowTelnetTerminalTypeResponse: ! a string 


! X Server Features Menu 


| 
‘3 SS SSS se ars rssh shes 


Visual*BackingStoreDefaultMode: 
Visual*PreX11R4BugCompatibility: 
Visual*OldDecWindowsCompatibility: 
Visual*XProtocolErrorReporting: 
Visual*VerboseMessages: 
Visual*Grayscale: 


{ 
M aS 


! Screen Saver Menu 


aan ner 


Visual*EnableScreenSaver: 
Visual*ScreenSaverTimeout: 
Visual*PreferredScreenSaver: 


{ 
: SSeS vanes esses hess 


' Remote Configuration Menu 


! 
. EE eee 


Visual *BootServerUsing: 
Visual*BootHostList: 
Visual*BootFilename: 


Visual*NetworkFileTransferProtocol: 


Visual *AutoLoadConfiguration: 
Visual*RConfigurationHostList: 
Visual*AutoLoadRgbDatabase: 
Visual*RgbDatabaseList: 

Visual *AutoLoadKeyboardMap: 
Visual*KeyboardMapList: 


o— oon om om om Cum 


o—_ o—_ ea o-_ o—m —_ —_ o_ ea —_ 


Disabled, When Requested, When Mapped 
Enabled, Disabled 
Enabled, Disabled 
Enabled, Disabled 
Enabled, Disabled 
Enabled, Disabled 


Yes, No 
Number of minutes 
Blanking, X Logo 


ROM, TFTP 

Host ID’s 

Path to boot file 
TFTP, NFS 

On, Off 

Host ID’s 

On, Off 

Host ID’s 

On, Off 

Host ID’s 
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Keyboard Map File Specification 
See SS SO ae 


NOTICE: 


The Keyboard Map download file has a format similar to the Remote Con- 
figuration file, consisting of one or more key assignment lines of the form: 


Keycode = Keysymbol Keysymbol .. . 


Blank lines are ignored, and an exclamation point (!) anywhere on a line 
signifies that the rest of the line is a comment. Case is not important any- 
where except when it matters to a particular option value, such as a UNIX 
file name. A continuation to the next line is indicated by a backslash (\) 
in the last position on the line. Values within a line may be separated by 
either SPACE or TAB characters. 


The first line in the file is a header, containing the following information: 
° the number of keysymbols to be changed 


° the maximum number of keysymbols to be assigned 
to any one keycode. 


The following keymap file example changes function keys F5 through 
F8 to serve as a simple hexadecimal keypad. Use the standard X client 
xprkbd to display the current mapping of key codes to key symbols. 


If your XDS is setup to use the standard US English keyboard, the XDS 
interprets both Left Alt (Alt_L) and Right Alt (Alt_R) keys as Xlib modifier 
Mod 1. If you have configured another language keyboard, or if you have 
downloaded a keyboard map file, the XDS interprets Left Alt as Mod1, and 
Right Alt as Mod2. 


: Sample Keyboard Map Download File. 


' The 4 keysymbols for each keycode are: 


! Unshifted, 


Shifted, Alt_Unshifted, & Alt_Shifted. 


| Se rsh ss sSSSSUnSe 


5 4 

11 = 0x0030 
12 = 0x0031 
13 = 0x0032 
14 = 0x0033 
94 = 0xff7e 


! nkeys = 4, width = 4 


0x0034 0x0038 0x0043 L Map. "FS" to.-"0%, #4", 8", *E* 

0x0035 0x0039 0x0044 ! map “F6" to “17, "5", "97, “p* 

0x0036 0x0041 0x0045 ! map “F7" to “°2", “6", “A”, “E* 

0x0037 0x0042 0x0046 i omap “FS* to *3%). =7%. +B. “pe 
{ map “Alt-R” to “Mode-switch’” 
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° A PolyText command with a string of more than 32 characters 
could display garbage when the font in use was paged. This has 
been corrected. 


: The Boot Host and Boot Filename items in the Remote Configu- 
ration menu no longer display the string “NpN” when no host or no 
filename is specified. 


° Loading two large bitmaps onto the root window when memory is 
low no longer crashes the server. 


3 Obscure out-of-memory conditions no lcager crash the server. 


Known Bugs in Release 3.0 


a ee 


The following minor bugs are known to exist Release 3.0: 


° Downloading a 2.8 server image with a 3.0 boot ROM or full-server 
firmware module causes minor configuration problems. See the 
X Display Station Release 3.0 Boot ROM Guide for information. 


° It is possible, though unlikely, that chaff from the cursor may be 
left in a window that uses a paged font. 


° When XDS memory is extremely low, a DestroyWindow operation 
may fail to completely remove a window from the screen. This may 
result in portions of windows (and their clipping regions) left on the 
screen. Resetting the server by selecting Close All Connections in 
the XDS System Window cleans up the display. 


° If XDS memory is extremely low, creating many non-rectangular 
shaped windows over an extended period of time may cause the 
XDS to hang. 


November, 1990 
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This document contains a correction to the X Display Station Release 3.0 
Update Guide, as well as information on Release 2.8 bug corrections, and 
Release 3.0 outstanding bugs. 


Remote Configuration Model Types 


= On page 18 of the XDS Release 3.0 Undate Guide, the second paragiaph 
under the heading “Remote Configuration File Specification” contains a 
list of MachineModel types for all XDS. models. Please use the following 
MachineModel identifiers (in bold type) instead of those in the guide: 


X14ES X-14/ES 

X15 X-15 

X19 X-19 (1152 x 900 resolution) 
X19ORIG X-19 (1024 x 800 resolution) 
X19TURBO X-19 Turbo 

XTC2 Color Xbase/10 

XTC3 Color Xbase/11 & Xbase/12 


Bugs Fixed for Release 3.0 
sisi SS essessusssesnes 
The following Release 2.8 software bugs have been fixed for Release 3.0: 


° Wildcard characters (*) in remote configuration files were not 
handled correctly, resulting in bogus error messages. Field separa- 
tors (.) were required, as in these examples: 


Visual.*.Keyclick 
© .* .Keyclick 


For 3.0, the field separators are not required, as shown here: 


Visual*keyclick 
*Keyclick 
ee X clients can no longer ring the bell when Audible Bell in the 
Configure Keyboard/Mouse menu is set to Off. 


° TFTP errors during the boot process were not flushed. Conse- 
quently, the boot command seemed to fail silently, and an error 
message was displayed after the next successful command. This 
has been corrected. 


(over) 
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Disclaimer: 

The information contained in this manual is believed to be accurate and reliable. 
However, Visual Technology Incorporated assumes no responsibility whatsoever 
for any errors, omissions, or inaccuracies. Visual Technology Incorporated dis- 
claims any and all warranties, express or implied, including the warranty of 
merchantability and fitness for a particular purpose, with respect to the informa- 
tion contained in this manual and the hardware and software described herein. 
The entire risk as to the quality and performance of such information and equip- 
ment is upon the buyer or user. 


Visual Technology Incorporated shall not be liable for any damages, including 
special or consequential damages, arising out of the use of such information or 
equipment, even if Visual Technology Incorporated has been advised in advance 
of such damages. The use of the information contained in this manual and the 
equipment described herein is subject to Visual Technology Incorporated's stan- 
dard license agreement, which must be executed by the buyer or user before the 
use of such information or software. 


This warranty gives you specific legal rights. You may also have other rights, 

which vary from state to state. Some states do not allow the exclusion or limita- 
tion of incidental or consequential damages or limitations on how long an implied 
warranty lasts, so the above limitations or exclusion may not apply to you. 
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UNIX is a trademark of AT&T Bell Laboratories. 

X and thegf Logo are trademarks of the Massachusetts Institute of Technology. 
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Introduction 


_— eee 


The boot ROM is a firmware module that requires an X Display Station 
(XDS) to download an image of XDS software into RAM from a network 
host using the Trivial File Transfer Protocol (TFTP). This software image - 
consists of the X server and fonts necessary for XDS operation. Download- 
ing via the boot ROM allows you to install updated versions of XDS soft- 
ware on a Single boot host, rather than installing a new, full-server firm- 
ware module on each XDS at your site. 


Reading the Tape Cartridge Files 


The XDS tar formatted boot tape you have received contains X-15, X-19. | 
and X-19 Turbo server images, a README file, a sample remote configura- 
tion file, and a source code patch file for XDMCP enhancement. 


To extract the entire contents of the tape, you must have 8 Mb of disk 
Space available. If so, execute the folowing commands: 


cd /tftpboot 
mkdir Visual 
cd Visual 
tar xv 


If your system uses a secure version of TFTP, then you should create a 
new sub-directory for the boot image in /tftpboot. Otherwise, you could 
use /usr/lib, or whatever directory you wish. mkdir Visual creates a new 
sub-directory Visual, cd Visual changes the current directory to Visual, 
and tar xv extracts the entire tape contents, puts all files into the current 
directory, and lists those les on the screen. 


If you wish to extract an individual download image, change the above tar 
command to one of the following: 


tar xv Doc x19 
tar xv DOC X190RIG 
tar xv DOC X19TURBO 
tar xv Doc x15 


Each of the image directories requires about 2 Mb of disk space, 

and contains two server image files: for example, /X19/X19-3.0 and 
/X19/X19-3.0L. They differ in that the image ending in “L” has the local 
client feature, and the other version has no local client. (See “XDMCP 
Host Selection Mode” in the X Display Station Release 3.0 Update Guide.) 
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There are two X-19 image directories for different versions of the XDS 
model X-19. The original X-19 has a 1024 x 800 screen resolution, and 

a 9-pin video connector on the XDS base unit. The later X-19 has an 

1152 x 900 screen resolution, and a 15-pin video connector on the XDS 
base unit. Note that both models have 9-pin video connectors on the moni- 
tor. The resolution is printed on the large label on the back of the monitor. 


Setting Up Network Protocols 


The XDS requires TFTP to download the X server image from the boot 
host. You should be sure that your system s.:pports TFTP before attempt- 
ing to use the boot ROM. If you are uncertain whether or not TFTP is 
running on your system, refer to the section “Verifying and Starting TFTP” 
in this guide. 


Modifying the BOOTP Database 


If you wish to use BOOTP to configure your XDS, you must add XDS 
information to the host BOOTP database file. usually /etc/bootptab. 


First, add a subnet entry for each XDS model on the network. An entry for 
a model X-15 would look like the following example: 


subnet .X15: \ 
:9mea255.255.0.0:\ 
:htsethernet: \ 
:49202128.0.0.1:\ 
2082128 .0.0.1:\ 
:hda/tftpboot /Visual/X15: \ 
:b£2X15-3.0 


The “\" is simply a line continuation character added for clarity — you 
could eliminate “\” and type all of the above as one line of input. The 
above subnet entry parameters are: 


sm - the subnet mask 

ht - the hardware type 

ds - the IP address of the domain nameserver host 
ms - the IP address of the IEN-116 nameserver host 
hd - the home directory of the XDS boot image file 
bf - the name of the boot image file. 


You can now add a bootp entry for each individual X-15 terminal on the 
network. This must follow the subnet entry in the bootptab file: 


xdsil: tcssubnet .X15 :has00002210019c: ip#128.0.4.202: 


where “xds1” is any name for your XDS. The above parameters are: 


tc - refers to the model X-15 subnet entry 
ha - the hardware address of the individual XDS 
ip - the IP address of the individual XDS. 


NOTICE: 
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Modifying the RARP Database 


If you are using RARP to configure your XDS, you must update the RARP 
database file, which is usually /etc/ethers. This entry is a machine hard- 
ware address followed by an ASCII name. or alias. For example, the above 
X-15 entry might be 


0:0:22:10:1:9¢ nickname 
where nickname is whatever name you assign to the individual XDS. 


The RARP daemon requires that each byte of the hardware address has no 
leading zero. 


Once you have updated the BOOTP or RARP database file, you may want 
to add an individual XDS entry to the / etc/hosts file. This would allow you 
to refer to the XDS by an alias name rather than its IP address. The re- 
quired format is the machine IP address followed by whatever aliases you 
wish to use: 


128.0.4.202 xdsl nickname 


Initial Boot ROM Configuration 


NOTICE: 


The first time you power up your XDS with the boot ROM module, it per- 
forms a Series of self-tests, displays a logo, and the messages “Testing 
Video Memory” and “Testing Dynamic Memory’. It then shows a message 
similar to this: 


Selfitest passed: (4096K+0K) 4096K Bytes dynamic memory. 
Video Ram - 512K Bytes. 

"68020 ROM version 3.0 - Nov 6, 1990 

Load error: not configured 


The two first lines tell you the XDS is working, show the total RAM 
installed, and the amount of video RAM . (The figures in parentheses 
“(4096K+0K)” are used for internal diagnostic purposes only.) The next 
line tells you the release date and version number of the boot ROM. “Load 
aye: not configured” only means that you have not yet entered any con- 
Mieation data into XDS non-volatile memory. 


Language Codes: O=US, l=German, 2=French, 3=l%, 4=Swed:sh/Finnish 
Keyboard Language [0]: 


This sets the keyboard language: Since further Setup items may be 
affected by the keyboard language mapping, set this value first. Press 
<Enter> to accept the default “0” for US English, or type in the number 
corresponding to your keyboard, followed by <Enter>. 


If your XDS has the VT220 keyboard, you may only select US English. 
SO eee SEBS. 


NOTICE: 


NOTICE: 
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This item sets the Ethernet cable interface. Press <Enter> to accept thick 
wire, or type “thin” and <Enter> to set the XDS for thin wire. 


-? address (0.0.0.0!: 


This is the IP address of the XDS. If you wish to use BOOTP or RARP 
allowing the XDS to automatically determine its IP address, press <Enter> 
to accept the default zero value. If you are not using the BOOTP/RARP 
facility, you must enter a valid IP address. 


Boot host 1 [BOOTPHOST!: 


Boot host 2 []: 128.0.0.40 
Boot host 3 []: roeket . 
Boot filename []: /t£tpboot /Visual/X19TURBO/X19TURBO-3.0 


“BOOTPHOST? is a special XDS keyword. If you choose to boot using 
BOOTP or RARP, then wherever in the XDS setup menus the keyword 
“BOOTPHOST’ appears, the XDS substitutes the IP address of the first 
host responding to BOOTP or RARP. 


This item allows you to specify the location of the XDS software image file 
on your network. If you accept the default keyword “BOOTPHOST” the 
XDS attempts to obtain this information using BOOTP or RARP. You may 
enter up to 3 boot hosts. If BOOTP/RARP fails. the XDS prompts you for 
this information again at boot time. If you choose not to use BOOTP or 
RARP, you should change “BOOTPHOST to a specific host IP address. 
Boot host 2, Boot host 3, and Boot filename have no default values. 


You can refer to a boot host by name rather than IP address only if you 
have specified a host as a Domain nameserver or IEN116 nameserver. (See 
“Full Boot ROM Configuration” below.) 


After you have entered these initial setup values, the XDS displays this 
message, followed by the boot ROM command menu (described below): 


Standalone configuration saved 
Ethernet address is 00:00:22:10:01:9¢, Thin BNC selected 


Auto-Booting 


Once you have configured the XDS, an auto-boot sequence occurs at 
power-up. The boot ROM displays a message similar to the following: 


Selftest passed: (4096K+0K) 4096K Bytes dynamic memory. 
Video Ram - 512K Bytes. 

68020 ROM version 1.0 - Feb.20, 1990 

Ethernet address is 00:00:22:10:01:9¢, Thin BNC selected 


Press ENTER within 10 seconds to prevent auto-boot 
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If you do not press <Enter> within 10 seconds, the XDS initiates the auto- 
boot procedure. If you press <Enters, the XDS displays the boot ROM 
command menu. 


The Boot ROM Command Menu 


This is the boot ROM command menu: 


Commands : 
boot [host file] Seriai [{baudrace: 
Ping host (timeout (count) ] telnet [host iporz:) 
Letstats [slilri config [full: 
diagnostics reset (factory) 
romboot 


the following examples: 


boot 128.0.0.40 /tftpboot /Visual/X19TURBO/X19TURBO-3 .0 
b 128.0.0.40 /t£tpboot /Visual /X19TURBO/X19TURBO-3 . 0 


reset factory 
re 


romboot 
ro 


boot [host file] 

Use this command to boot the XDS, and also to specify the host and path 
of the software image file. If you have already configured the boot host and 
path, the host and file arguments are optional. 


ping host (timeout [count]] 
If :7ou cannot establish a host connection, you can send a ping (Packet 
InterNet Groper) packet to that host to find out if it is responding. The 
heet you wish to ping is a required argument. The default timeout is 5 

f s. Count, the number of times you wish to send a ping packet, has 
a'Gefault of one. 


netstats [s | i] r] 


This command causes the XDS to display sets of network statistics. The. 
option flags notify the XDS to show the following information: 


s - display protocol statistics 
i - display InterNet statistics 
r - display network data tables 


no option flag displays all of the above plus connection data. 


NOTICE: 
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diagnostics 
This command invokes the boot ROM diagnostics menu. These functions 
are described in “The Boot ROM Diagnostics Menu” below. 


romboot 

The XDS with a full-server firmware module can either download a host 
server image file, or use the X server in firmware. If your XDS has full- 
server firmware, use romboot to boot using the firmware X server. (See 
“Accessing Diagnostics with Full-Server Firmware” below.) 


If your XDS has boot ROM firmware, this command is the same.as reset 
without the éactory option. 


serial [baudrate] 

This enables you to initiate (or resume) a VT100-emulator session on the 
XDS serial port at the specified baudrate. Without the baudrate option, 
the XDS uses the default 9600, or whatever baudrate you have config- 
ured. To suspend a terminal session on the serial port, press <Connect> 
on a VI220-compatible keyboard, or <SysRq> on a PC/AT-compatible 
keyboard. 


telnet [host [port]] 

This command initiates (or resumes) a VT100-emulator TELNET session to 
the specified host and (optional) host pert. You must specify a host when 
first starting a TELNET session — when you resume a suspended session, 
the host argument is optional. (See “TELNET Escape Sequences” below.) 


config [full] 

This command allows you to configure your XDS. Without the full option, 
the XDS prompts you for the same information described in the “Initial 
Boot ROM Configuration” section, above: keyboard language, Ethernet 
interface, IP address, boot host, and boot filename. If you select full, you 
can specify more detailed information, described in the “Full Boot ROM 
Configuration” section below. 


reset [factory] 

This command restarts the terminal. With the factory option, reset erases 
all configuration data stored in static (non-volatile) memory, and restores 
the XDS to its original factory settings. 


TELNET Escape Sequences 


While you're in a TELNET session, you can use the following escape 
sequences. (Press <Break> and one of the following characters to perform 
an escape sequence.) 


To see the list of commands, press <Break> plus any key not listed below. 
The XDS shows you the list of commands. 
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checks if the host is responding, and if yes, displays a message 
sends a break to the remote TELNET 

flushes any output 

erases a character 

closes the TELNET connection 

displays TELNET and TCP statistics 

aborts by resetting the TELNET connection 

suspends TELNET and displays the boot ROM commands. 


Pressing <Connect> or <SysRq> suspends the TELNET session and dis- 
plays the boot ROM command menu. To resume a suspended session, 
type telnet (or t) and press <Enter>. 


NH @®,.0O Fo p 


The Boot ROM Diagnostics Menu 


NOTICE: 


NOTICE: 


This is the boot ROM diagnostics menu: 


Commands: 
comprehensive burn-in [dvt] 
memtest [start end]  sramtest (check) 
ethertest [count] serialtest 
clocktest keybdtest 
mousetest align [hv] 
config netstats 
graytest bootmenu 


> 


As with the boot ROM commands, select a command by typing the name 
followed by <Enter>, or the name and any optional arguments separated 
by <Space> characters, followed by <Enter>. You may also select a com- 
mand by entering a minimum identifiable character String. 


Some of the tests require special loopback connectors on the back of the 
XDS base unit. These are described under “Loopback Connectors” below. 
LLL sh espnsunsnenenseternte eee ne 


comprehensive 


This performs memtest, sramtest, clocktest, keybdtest, serialtest, and 
ethertest in succession, one time each. These tests are described below. 


You must install all loopback connectors for this series of tests (but only 
qua Ethernet loopback connector — see ethertest below). 


The Cam nrahariatoa ta 
The comprehensive test erases all user-specified configuration settings. 
ee ee eee 


memtest [start end] 


This tests the XDS volatile (dynamic) RAM. Two tests are performed for 
each loop: (1) a march test, which writes and reads back a unique value 
for each address, and (2) a stress test, which writes and reads back known 
pattems. Press any key to quit the test. Start and end specify an optional 
address range. 


NOTICE: 


NOTICE: 
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ethertest [count] 


Performs an Ethernet loopback test as many times as requested by the 
optional count. The default count is one. 


This test requires one loopback connector on either the thick or thin 
Ethernet port, depending on how you have configured Ethernet. 


clocktest 


This verifies that 100 clock ticks occur within a fixed time period. The 
acceptable error range is + 4%. 


mousetest 

This verifies that the mouse is communicating correctly with the the XDS. 
The characters “< > 4 v” shown on the screen indicate the direction of 
mouse movement, and “o” indicates which mouse button is down. Press 
any key to terminate the mouse test. 


config 

This allows you to configure your XDS for keyboard language, Ethernet 
interface, IP address, boot host, and boot filename. This is the same as 
config (without the full option) in the boot ROM command menu. 


graytest 

For grayscale models only, this displays 4 test patterns on the screen in 
succession. Press <Enter> to go to the next pattern, and to return to the 
diagnostics menu. 


burn-in [dvt) 

This performs memtest, sramtest, clocktest, keybdtest, serialtest, and 
ethertest in succession, continuously, until you power off the XDS. With 
the dvt option, burn-in runs a series of 4 screen alignment test patterns 
concurrently with the above tests. 


You must install all loopback connectors for this series of tests (but only 
one Ethernet loopback connector). 


The burn-in test erases all user-specified configuration settings. 


sramtest (check) 

This tests the XDS non-volatile (static) RAM. Two tests are performed for 
each loop: (1) a march test, which writes and reads back a unique value 
for each address, and (2) a stress test, which writes and reads back known 
patterns. Press any key to quit the test. 


The sramtest test erases all user-specified configuration settings. Do not 
use the check option, which is for internal manufacturing tests only. 


serialtest 


This tests the integrity of the asynchronous and mouse serial ports. This 
test requires both asynchronous and mouse loopback connectors. 
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keybdtest 

This tests keyboard integrity. During the interactive portion of the test. 
the XDS prompts you to press each key once. This verifies which keys are 
pressed and how often, and reports multiple presses of individual keys. 


align [hv] | 

This displays 4 screen alignment test patterns in succession. Press 
<Enter> to go to the next pattern, and to return to the diagnostics menu. 
Pressing the <Space> bar at any time inverts the current pattern. 


The hv option causes the XDS to display a white border around a solid 
black screen. With hv selected, <Spaca> results in a black border around. 
the edge of a solid white screen. You can use the hy patterns to check the 
monitor for high voltage as well as screen alignment. 


netstats 


This gives you the same network statistics as netstats (with no option) 
from the boot ROM command menu. 


bootmenu 
This selection brings you back to the boot ROM command ‘menu. 


Loopback Connectors 


You need four special loopback connectors to run 54321 
all of the above tests. The mouse loopback is a 
9-pin, female D-sub connector with the following 
pins wired together: (2 & 3 & 6). 


987 6 


Ts 
131211109 87654321 The asynchronous serial port 


loopback is a 25-pin, female D-sub 
connector with the following pins 
wired together: (2 & 3), (4 & 5 & 8), 
(6 & 20), (12 & 23). 


2 24 23 22 21 20 19 18 17 16 15 14 


be ; ee | 

The Ethernet thickwire AUI loopback is a 15- reese Te 
pin, male D-sub connector with the following 
pins wired together: (3 & 5), (6 & 9), (10 & 12). 


The Ethernet thinwire BNC loopback is a = 
T-shaped, male connector with a terminator 9 10 11 12 13.14 15 
and ground lead on each end that would nor- Ld 

mally connect to the network cable. 
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Accessing Diagnostics with Full-Server Firmware 


If your XDS has a full-server firmware module instead of a boot ROM 
module, you can still access the boot ROM command and diagnostic 
menus by performing these steps: 


ie Log out of your current session — you will have to reboot the XDS, 
and cannot resume. 


2. Press <Connect> on the VT220 keyboard to bring up the Connec- 
tion Window. On the PC/AT keyboard, press <SysRq> to bring up 
the XDS System Window, and then select the Connection Window. 


3. Type “STANDALONE” in upper case, as shown below: 


Enter serial ‘baudrate! ping host [timeout’ 
telnet hest [port? netscacs Sosy 
: STANDALONE 


4. Respond by typing “yes” (or “y") and <Enter> to this prompt: 
Enter standalone diagnostics: are you sure? yes 


5. The screen goes black, and the XDS displays the following message. 
Press <Enter> immediately to bring up the boot ROM commands. 


Press ENTER within 10 seconds to prevent auto-boot 


You can now choose any boot ROM command, or any test if you go to the 
diagnostics menu. Select romboot to start up your XDS using the full- 
server firmware. 


Full Boot ROM Configuration 

assess essnssasnssssussssesssserssesessereereeereeeers 
If you select config with the full option from the boot ROM command 
menu, the XDS prompts you to supply the following information. Default 
values, enclosed in square brackets, apply if you press <Enter> only. 


Language Codes: 0=US, 1l=German, 2=French, 3=UK, 42S ‘edisn/Finc:s- 
Keyboard Language [0]: 


LANCE network 
Enapled [y!: 
Thick AUI or Thin BNC ehiek!: 
IP address [0.0.0.0]: 
Network mask [0.0.0.0]: 
Broadcast address [0.0.0.0]: 


See “The Configure Ethernet Menu” in the X Display Station User's Guide 
for information on LANCE network Settings. 
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SLIP network 
Enabled [n]: 
=P address (0.0.0.0: 
Network mask (0.0.0.0): 
Broadcast address {0.0.0.0}: 


See “The Configure Serial Line Network Menu” in the X Display Station 
User's Guide for information on SLIP settings. 


Globals 
Default router (0.0.0.0): 
Nameserver request timeout (10): 
Default domain name ([]: 
Domain nameserver 1 (0.0.0.0): 
IEN116 nameserver 1 [0.0.0.0]: 
Boot host 1 [BOOTPHOST] : 
Boot host 2 []: 
Boot filename []: 


See “The Configure Network Services Menu” in the X Display Station User's 
Guide for information on the above global settings. % 


= 
ome 
_ 


Serial Port 
Baud rate [9600]: 
Data bits (7 or 8) (8): 
Parity [none]: 
Check receive parity [no]: 
Stop bits (1 or 2) [1]: 
Xon/Xoff Flow Control [yes]: 
RTS/CTS Flow Control [no]: 
Modem Control [yes]: 
RS422 select [no]: 


See “The Configure Serial Port Menu” in the X Display Station User's Guide 
for information on serial port settings. 


General 
Set new password? [no]: 
New password []: 
Retype password []: 


When selected, a password prevents unauthorized access to the config, 
Glagnostics, and reset factory commands from the boot ROM command 
ge. It also prevents unauthorized access to the Standard XDS setup 
miénus. You can clear an existing password by typing <Enter> only in 
response to the Set new password and Retype password prompts. 


Downloading XDS Release 2.8 to a 3.0 Boot ROM 


If you have a Release 3.0 Boot ROM module, you can still a download 

an XDS Release 2.8 server image. When you setup the boot file, simply 
specify the pathname of the XDS 2.8 server image instead of the XDS 3.0 
Server image. You must, however, manually specify the 2.8 boot file every 
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time you reboot the XDS. This is due to a boot command syntax change in 
the 3.0 boot ROM. 


When you reboot the XDS after downloading an XDS 2.8 server image, 
press <Enter> to stop the auto-boot sequence. If you select config to check 
the boot file, you see something like the following. Note that the boot host 
entry incorrectly includes the boot file path: 


Booc: host 2° 228.0-0.40 /8S0/.2_/xdslib/X15-2.8: 


You can simply specify the 2.8 boot file using the boot command, 
although you must do this whenever you reboot. 


> B128.0.0.40 /usr/lib/xdslib/x15-2.8 


If you boot an XDS 3.0 server, however this problem goes away, and you 
can auto-boot the XDS as usual. 


Verifying and Starting TFTP 


On systems running BSD UNIX, you can use the following examples find 
out whether TFTP is running on your system. The command syntax is 
slightly different for System V UNIX — see your system administrator for 
assistance. 


Since the most common way TFTP runs is through the inetd daemon, you 
can execute the following command to determine the set of inetd pro- 
cesses: 


Ps aux | grep inetd 


If this command locates an inetd other than that used to execute grep. 
then the inetd daemon is running on your system. You should now check 
the inetd configuration file to verify (1) that the line used to start TFTP is 
not commented out, and (2) that the TFTP command does not contain the 
-S option. The inetd configuration file on most systems is /etc/inetd.conf. 
On some older systems is /etc/servers. | 


In /etc/inetd.conf the TFTP command should look something like this: 
«tftp dgram udp wait root /usr/ete/in.tftpd in.cftpd 
In /etc/servers the TFTP command should look something like: 
tftp udp /usr/etc/in.tftpd 


In either case, make sure that the TFTP line is not commented out, and 
that there is no -s option. If you should have to change the configuration 
file and inetd is already running on your system, send a “hangup” signal 
to the inetd process to force it to reread the configuration file. To do this, 
first determine the process ID of inetd by executing 


Pps aux | grep inetd 


XDS Release 3.0 Boot ROM Guide 17 


The process ID is the number in the second column from the left. Use this 
number to send the “hangup” Signal as follows: 


kill -HUP <process ID> 


The inetd process is not actually killed, but rereads the configuration file 
and starts TFTP in the proper manner. 


If ps|grep does not locate inetd, then your system may be running TFTP 
directly, rather than through inetd. Use the ps| grep commands to check 
for TFTP instead of inetd: 


PS aux | grep tftpd 


If the above steps fail to locate inetd, see your system manager about 
Starting up inetd and adding it to your /etc/re system boot file. If your 
system does not support inetd, then you may start TFTP directly by enter- 
ing the following path and command: 


/etc/tftpd 


Booting Your XDS Using SLIP 


You can easily boot your XDS using SLIP (Serial Line Internet Protocol) as 
well as Ethernet, provided your XDS has a valid SLIP IP address: 


1. Enter the relevant SLIP information into your XDS using the config 
command with the full option. (See “Full Boot ROM Configuration” 
above.) You can leave the network mask and broadcast address set 
to zero. 


2. Select boot from the command menu. When you are prompted for 
‘the boot host, be sure you give its SLIP address (which is not the 
Same as its Ethernet IP address). 


3. Press <Enter> and the XDS should boot. Please note that you can- 
not use BOOTP and RARP when booting the XDS over SLIP. 


VISUAL 
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